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Running Xindice with Tomcat 


1. Intended audience 


This How-to is aimed at developers or administrators who want to install Xindice with 
Tomcat. 


2. Prerequisites 


The most important prerequisite is patience. Take lots of deep breaths. It will work. It just 
might take some time. 


e You should have already compiled Xindice. 

e You must have an existing installation of Tomcat. You should use version 4.1.12 or 
higher. You can download Tomcat from the Jakarta website. 

e Be sure to set the CATALINA HOME environmental variable to point to the location of 
your Tomcat installation. 


3. Steps 


3.1. Place holders used in the Steps 


e {XINDICE_HOME} - Directory where you have unzipped your Xindice source files. 
* (JAVA VERSION] - Installed JDK Version. 


3.2. Copy the WAR file 


If you've followed the prerequisites, then you will have a working version of Tomcat 
installed, and the sources of Xindice compiled. Now, copy the xindice-*.war file from 
(XINDICE HOME| to the $SCATALINA HOMES/webapps. 


It is important to rename the file while copying to the xindice.war, as name of the file defines context name, and Xindice 
clients and tools use xindice context name by default. 


Here's what that looks like in Windows: 


> cd (XINDICE HOME] 
2 (ghi sliachi@e=* 


Directory of (XINDICE HOME] 


(09/21/2007 — (ood eni 629, O94 xaliachiee—il o2 s eue 
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09/27/2007 09:24 PM 5,184,315 xindice-1.2.war 
09/27/2007 09:24 PM 1,791 xindice-1.2.xml 
09/27/2007 09:24 PM 6,535 xindice-dom-1.2.Jjar 
4 File(s) 5921, 335 lotes 
QO Dir(s) 3,745,992,7704 bytes free 


> copy xindice-1.2.war SCATALINA_HOME%\webapps\xindice.war 
1 file(s) copied. 


If you are using Linux, your session might resemble: 


$ cd (XINDICE HOME] 

SSE indice i 

zindicen k2 Jar xindice-1.2.war xindice-1.2.xml 
xindice-dom-1.2.jar 

$ cp xindice-1.2.war $CATALINA HOME/webapps/xindice.war 


3.3. Edit the Tomcat's server.xml File (Optional) 


Tomcat will automatically deploy copied war file with the default settings. To modify those 
defaults, CATALINA HOME/conf/server.xml file should be edited. Suggested 
changes for the server.xml file are contained in the 

(XINDICE HOME)/xindice-1.2.xml file. 


3.4. Restart Tomcat 


Restart your Tomcat server to be certain that it picks up the Xindice servlet. This step is 
required if you have edited CATALINA HOME/conf/server.xml file. In other cases, it 
is usually not required. 


Here's what that looks like in Windows 


> cd SCATALINA_HOME%\bin 

> startup 

Using CATALINA_BASE: D:Njakarta-tomcat-4.1.12 
Using CATALINA HOME: D:Njakarta-tomcat-4.1.12 
Using CATALINA TMPDIR: D:NVjakarta-tomcat-4.1.12Ntemp 
Using JAVA HOME: C:Nj2sdk (JAVA, VERSION] 


In this example, I have installed Tomcat in D: Njakarta-tomcat-4.1.12.lf you've installed it in another location, just 


ensure that the CATALINA HOME environmental variable points to your Tomcat installation directory, or substitute that path 
forD:Njakarta-tomcat-4.1.12. 
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Here's what that might look like on Linux 


$ cd S$CATALINA HOME/bin 
S .j/ecaralima.sla scare 


Using CATALINA BASE: /var/tomcat4 

Using CATALINA HOME: /var/tomcat4 

Using CATALINA TMPDIR: /var/tomcat4/temp 

Using JAVA HOME: /usr/java/jdk(JAVA VERSION) 


The name of the Tomcat installation directory may differ for your Linux platform. The default location is /var/tomcat 4. If 
you are unsure of the location, check the tomcat4 . conf file in your /etc/tomcat4 directory. 


Warning: 


If you installed the RPM version of Tomcat v4.x, you may need to enter "tomcat4 start" to invoke the Tomcat server. 
The FreeBSD version of Tomcat may be using tomcat41ct1. 


3.5. Verify the installation 


When Tomcat restarts on Windows, you should see a new window open entitled "Tomcat', 
and it should look something like this. (Note the xindice classes loading.) 


Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry loadRegistry 
INFO: Loading registry information 

Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry getRegistry 
INFO: Creating new Registry instance 

Nov 21, 2002 1:42:08 PM org.apache.commons.modeler.Registry getServer 
INFO: Creating MBeanServer 

Nov 21, 2002 1:42:09 PM org.apache.coyote.httpll.HttpllProtocol init 
INFO: Initializing Coyote HTTP/1.1 on port 8080 

Starting service Tomcat-Standalone 

Apache Tomcat/4.1.12 

Nov 21, 2002 1:42:21 PM org.apache.xindice.core.Database setConfig 
INFO: Database points to D:\jakarta-tomcat-4.1.12\bin\.\db 

Nov 21, 2002 1:42:23 PM org.apache.xindice.server.XindiceServlet init 
INFO: Database successfully started 

Nov 21, 2002 1:42:24 PM org.apache.coyote.httpll.HttpllProtocol start 
INOS Strarcing Coyos IDEE 1.1 om pore BORO 

Nov 21, 2002 1:42:24 PM org.apache.jk.common.ChannelSocket init 

INFO: JK2: ajpl13 listening on tcp port 8009 
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Nov 21, 2002 1:42:24 PM org.apache.jk.server.JkMain start 
INFO: Jk running ID-0 time-20/70 
config-D:NVjakarta-tomcat-4.1.12NconfNjk2.properties 


Here's what the SCATALINA HOME/logs/catalina.out output looks like on Linux 


[INFO] Registry - -Loading registry information 

[INFO] Registry - -Creating new Registry instance 

[INFO] Registry - -Creating MBeanServer 

ONOJ lsherejoililPirceoeoll = =-rmaicielizine Coyoce ISDN dL. dL on pore 8060 


Starting service Tomcat-Standalone 
Apache Tomcat/4.1 

Server 1.6 is running 

Press [Ctrl]+[C] to abort 


HNO lsherjoiliPmocoeoll = —Sleaimcnine; Coyos Burin /il., il om pore SOO 
[INFO] ChannelSocket - -JK2: ajp13 listening on tcp port 8009 
[INFO] JkMain - -Jk running ID-0 time-4/168 


config-/var/tomcat4/conf/jk2.properties 


In addition, you should be able to verify that xindice is running by loading this URL in your 
browser http: //localhost:8080/xindice.Ifit works, you should see the Xindice 
"List Databases" page which allows you to browse the contents of the database. 


If you run into problems, don't worry. Be sure to send feedback so that we can improve these 
documents for the next person. 
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